package com.rbac.admin.service.system;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.rbac.admin.dto.system.UserDTO;
import com.rbac.admin.entity.system.SystemUser;
import com.rbac.admin.vo.system.UserVO;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;
import java.util.Map;

/**
 * 用户服务接口
 *
 * @author rbac-admin
 * @since 2024-07-18
 */
public interface UserService extends IService<SystemUser> {

    /**
     * 根据用户名查询用户信息
     *
     * @param username 用户名
     * @return 用户信息
     */
    SystemUser getUserByUsername(String username);

    /**
     * 分页查询用户列表
     *
     * @param page 分页参数
     * @param user 查询条件
     * @return 用户列表
     */
    IPage<UserVO> getUserPage(Page<UserVO> page, SystemUser user);

    /**
     * 查询用户详情
     *
     * @param userId 用户ID
     * @return 用户详情
     */
    UserVO getUserById(String userId);

    /**
     * 创建用户
     *
     * @param userDTO 用户数据
     * @return 用户信息
     */
    UserVO createUser(UserDTO userDTO);

    /**
     * 更新用户
     *
     * @param userId 用户ID
     * @param userDTO 用户数据
     * @return 用户信息
     */
    UserVO updateUser(String userId, UserDTO userDTO);

    /**
     * 删除用户
     *
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean deleteUser(String userId);

    /**
     * 批量删除用户
     *
     * @param userIds 用户ID列表
     * @return 是否成功
     */
    boolean batchDeleteUsers(List<String> userIds);

    /**
     * 重置密码
     *
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean resetPassword(String userId, String newPassword);

    /**
     * 修改用户状态
     *
     * @param userId 用户ID
     * @param status 状态
     * @return 是否成功
     */
    boolean changeStatus(String userId, Integer status);

    /**
     * 获取用户角色ID列表
     *
     * @param userId 用户ID
     * @return 角色ID列表
     */
    List<String> getUserRoleIds(String userId);

    /**
     * 分配用户角色
     *
     * @param userId 用户ID
     * @param roleIds 角色ID列表
     * @return 是否成功
     */
    boolean assignRoles(String userId, List<String> roleIds);

    /**
     * 导出用户数据
     *
     * @param queryUser 查询条件
     * @return 文件路径
     */
    String exportUserData(SystemUser queryUser);

    /**
     * 导入用户数据
     *
     * @param file 导入文件
     * @return 导入结果
     */
    Map<String, Object> importUserData(MultipartFile file);
} 